home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 4 / United Public Domain Gold 4.iso / tbag / tb019.dms / tb019.adf / Doc-Files / Utilities.Doc < prev    next >
Text File  |  1988-04-30  |  35KB  |  910 lines
  1.  
  3. Utilities Docs
  5. This file includes Documentation for all files in the Utilities Drawer. They 
  6. have all been combined into one to save disk space.
  7.  
  8. The Docs included in this file are:
  10. Formula!
  11. Lista
  12. MachII
  13. Pyro
  14. SPTOY
  16.  
  17. Doc File Headers are in RED!
  18.  
  19. *****************************************************************************
  20.  
  21.  
  22.  
  24.  
  25.  
  26.     
  27.                     HERMES' FORMULA!  (Version 1.0)
  28.  
  29.                      Copyright (c) 1988 A. G. Kartsatos 
  30.  
  31.            (CIS = 76617,121, GEnie = XTH58515, PLink = HERMES)
  32.  
  33.  
  34.                         ***  Shareware Program  ***
  35.  
  37.      Here is a program that complements my CALCULA program and can be of
  38. considerable value to various professionals who use mathematical functions
  39. in their work.
  40.      It is a 3-dimensional function grapher.
  41.   
  42.      ATTENTION:  The "TOPAZ 11" font should be in your current "fonts" 
  43. directory.  If it is not there, you will get the program running with funny
  44. fonts or you will get a GURU!
  45.  
  46.      To use it from the CLI: Press "RUN FORMULA!".
  47.      To use it from the Workbench: Click its icon.
  48.      To exit, choose "QUIT" from the menu, or click into the EXIT gadget.
  49.  
  50.      Formula! will actually graph any valid expression involving the
  51. 17 supported algebraic and trigonometric functions, 3 constants involving
  52. PI and 5 algebraic operations.  
  53.      In order to use Calcula, do the following:
  54.  
  55.      (1)  Insert the function to be evaluated in the FUNCTION gadget. 
  56.      
  57.      (2)  Insert the values (if needed) for the six parameters in their
  58.           respective gadgets.  The front panel always appears with the
  59.           default values for the parameters.
  60.  
  61.      (3)  Click the GRAPH gadget.
  62.  
  63.      The function will be scaled first, and then it will be graphed on its
  64. own screen in the colors chosen by the user (COLOR gadget).
  65.  
  66.  
  67.      FUNCTION AND PARAMETER GADGETS INFORMATION
  68.      ==========================================
  69.  
  70.      (I)    Use only parentheses. No brackets are allowed.
  71.  
  72.      (II)   The function must be at most 100 characters long.
  73.  
  74.      (III)  This version does not support scientific notation.  Also, all
  75.             trigonometris functions are evaluated at angles expressed in
  76.             radians.  Use the rad function to convert degrees to radians.
  77.             This means degrees with decimals like: rad(87.6).
  78.  
  79.      (IV)   Avoid the use of numbers with more than 13 digits before
  80.             the decimal point and/or 9 digits after the decimal point.
  81.  
  82.      (V)    Exponential expressions grow or decay very fast.  The largest
  83.             power I have allowed for e is 32. (exp(32.)).
  84.  
  85.      (VI)   Check the available functions, operators, and constants by
  86.             choosing FUNCTIONS from the menu.  Make sure that you are
  87.             using the right notation for your functions.
  88.  
  89.      (VII)  To CLEAR ONE of the string gadgets, click into it and press
  90.             RIGHT-AMIGA-X.  
  91.  
  92.      (VIII) You may use spaces between any expressions.  No problem.
  93.  
  94.      (IX)   Lower or upper case letters are allowed anywhere in the  
  95.             function gadget. The program turns them all into upper case.
  96.  
  97.      (X)    For the sake of speed I have omitted error messages for a whole
  98.             lot of nonsensical things that can happen.  
  99.             Make sure your input makes sense mathematically.
  100.  
  101.      (XI)   The program will prohibit the generation of numbers that are 
  102.             prone to carry prohibitive sizes of error.
  103.  
  104.      (XII)  CTRL-N gets you to the Workbench and CTRL-M gets you back to
  105.             FORMULA!.  If you are planning to work on the Workbench while
  106.             FORMULA! is running, make sure to run it with "RUN FORMULA!"
  107.             and not just "FORMULA!".
  108.  
  109.      (XIII) The built in parameters pi, tpi and pit denote the numbers
  110.             PI, 2*PI and PI/2, respectively.
  111.  
  112.      (XIV)  The function "as" (asin) has values in the interval [-pit,pit];
  113.             The function "ac" (acos) has values in the interval [0,pi];
  114.             The function "atan" has values in the interval [-pit,pit];
  115.             The domain of "as" and "ac" is the interval [-1,1];
  116.  
  117.      (XV)   When you raise a function to a power, make sure you enclose
  118.             the function in parentheses.  For example, you should use
  119.             (exp(1.89))**2 instead of exp(1.89)**2.  The same remark applies
  120.             to other similar situations.
  121.  
  122.      (XVI)  The AZIMUTH lies always between 0 and 90 degrees while the
  123.             COLATITUDE ranges always between 0 and 180 degrees.
  124.             I will allow bigger AZIMUTH ranges in future versions.
  125.  
  126.      (XVII) DO NOT USE pi, tpi, pit in ANY GADGETS OTHER THAN THE FUNCTION
  127.             gadget.
  128.  
  129.     (XVIII) The RESET gadget on the front panel will bring back the default
  130.             values of the parameters, if needed.
  131.  
  132.  
  133.      GRAPH SCREEN AND PALETTE INFORMATION
  134.      ====================================
  135.  
  136.      (1)    Pressing "P" or "p" after the function is graphed, you get a nice
  137.             palette on the screen.  It will allow you to change the two
  138.             surface colors and the two grid colors very easily.
  139.             You can SAVE the picture with GRABBiT.
  140.  
  141.      (2)    The palette will exit if you click into its EXIT gadget.
  142.  
  143.      (3)    The screen with the graph will go into the background if you
  144.             press the TAB key or the RETURN key.  Natually, you can do
  145.             that after the palette is out.
  146.  
  147.      (4)    You can bring the graph screen back if you click into the VIEW
  148.             gadget on the main panel.
  149.  
  150.      (5)    When you bring the screen back via the VIEW panel, you must
  151.             click into it to activate it!  Otherwise it will NOT LISTEN
  152.             TO KEYBOARD COMMANDS LIKE "P", "p", TAB, RETURN.
  153.  
  154.      (6)    THE VIEW gadget will show you the screen with the graph,
  155.             provided there is a graph to show.
  156.  
  157.      (7)    The COLOR gadget could be used to modify the color of the current
  158.             or the next function.  If you want to modify the color
  159.             of the function already graphed, just flash it with the
  160.             VIEW gadget and then press "p" or "P" to get the palette on
  161.             it.  You can achieve the same result by (1) clicking COLOR on
  162.             the front panel, (2) modifying the palette, (3) getting the graph
  163.             screen back and (4) throwing the palette on it.
  164.             The next graph screen will automatically assume the current
  165.             palette collors.
  166.  
  167.      (8)    Again, you can SAVE the screen with GRABBiT.  I do not think
  168.             that CLIPiT will work here.
  169.  
  170.      HERE ARE SOME INTERESTING FUNCTIONS TO TRY (Default gadget values
  171.      ere used unless otherwise specified):
  172.  
  173.      (a)    sin(x**2 + y) - x + y;
  174.  
  175.      (b)    3*cos(x**2-y**2);
  176.  
  177.      (c)    3.45*sin(x-y**2), X-MINIMUM = -20;
  178.  
  179.      (d)    3.45*cos(2 - (x**2 + y**2)), X-MINIMUM = -5, Y-MINIMUM = - 5;
  180.  
  181.      (e)    3*cos(x**2) - ln(abs(x + y));
  182.  
  183.  
  184.                              ***  <<<-->>>  ***
  185.  
  186.  
  187.      This is a SHAREWARE copyrighted program.  If you find it useful, 
  188. please send $15.00 to:
  189.                
  190.                 A. G. Kartsatos   (= HERMES = SOULI)
  191.                 8524 Caladesi Island Drive
  192.                 Tampa, FL 33637
  193.                 (Telephone: 813-988-2146)
  194.  
  195.      With this contribution you will receive more programs written by the
  196. author.
  197.      FOR SUPPORT, call HERMES BBS in Tampa, FL.  A bulletin board with 1400
  198. files online and a healthy message base.  The board is private, but you
  199. can leave a message to the SYSOP concerning the HERMES programs and/or you
  200. can download ALL HERMES PROGRAMS without registering.
  201.  
  202.                 HERMES BBS Telephone: 813-985-7624.
  203.  
  204.      Other programs by the author:
  205.  
  206.      PALETTA.ARC    (Color Mixing, Modifying IFF's, Random Colors)
  207.      DUHERM26.ARC   (Great Directory Utility.  Macros, Parameters, etc)
  208.      CALCULA.ARC    (An Expression Parser And A Function Evaluator.  Unique!)
  209.      SIMPLICA.ARC   (The Simplex Method Of Linear Programming)
  210.      ROST.ARC       (Reports On Storage And Tasks.  Useful!)
  211.      LISTA.ARC      (Very Useful Directory Lister.  Version 1.1 Soon!)
  212.      SCRIPTA.ARC    (Online!-PCP Script Maker.  Easy script files!)
  213.  
  214.      Feel free to distribute this program, with the doc intact, to any
  215. bulletin boards and other non-profit establishments in the US and abroad.
  216.      These include PLink, Compuserve, GEnie, Delphi, etc.
  217.      The inclusion of this program, or any part of it, in any form in a 
  218. commercial package, or its use for commercial purposes, requires the 
  219. written permission of the author.
  220.      
  221.      Later...
  222.                   @@-->>> HERMES
  223.  
  224. *****************************************************************************
  225.  
  227.               
  228.                           HERMES' LISTA  (Version 1.1)
  229.  
  230.                       Copyright (c) 1988 A. G. Kartsatos
  232.  
  233.      TO RUN IT IMMEDIATELY: Press "LISTA" or "RUN LISTA" 
  234.                                     to list the current directory or
  235.                             Press "LISTA DF0:Souli" to list the directory
  236.                                    "Souli" in DF0:. (Just an example)
  237.  
  238.      TO EXIT:               Click into the WINDOWCLOSE gadget or into
  239.                             the center of the big rectangular area.  You
  240.                             may also just press the TAB key.
  241.  
  242.      This is a Directory Lister.  Around 10.9K, it will still fit perfectly 
  243. into your c directory.  
  244.      It will list your files alphabetically with their respective sizes.
  245.      It will also list the number of files and the number of sub-directories
  246. in the requested drive/directory.
  247.      It now contains a CLI gadget that will allow you to execute any CLI
  248. command.
  249.      It will also allow you to highlight all the files with names containing
  250. the word that you insert in the horizontal string gadget.
  251.      It will handle up to 400 files.
  252.  
  253.      I open the LISTA window a little bit further to the right now so that
  254. the user can see part of the Amiga responses.
  255.  
  256.      GADGETS:
  257.  
  258.      (I)   RE:  This gadget will refresh the listing of your files whenever
  259.            you click into it.  For example, if you delete a file in the
  260.            directory you are in, the listing of the files will not be
  261.            automatically refreshed.  To see the change, you must click
  262.            into this gadget.  I did this to avoid continuous refreshing
  263.            of (sometimes too many) files after each change.
  264.  
  265.      (II)  EX:  This useful gadget will execute any CLI command that you
  266.            put into your horizontal string gadget.  Remember though:  do
  267.            not use CD in that command.  You will be CD'ed to the desirable
  268.            directory, but LISTA won't!!!  Click into the CG gadget before
  269.            you write your command in.  There might be strings still left
  270.            in the horiz. string gadget that you cannot see!
  271.  
  272.      (III) CG:  Clicking into this gadget, you CLEAR the contents of the
  273.            buffer of the horizontal string gadget.  Necessary for the
  274.            insertion of patterns and commands.
  275.  
  276.      (IV)  CP:  This gadget will clear the highlighting of all the files
  277.            that were highlighted by the PAT gadget.  It is not necessary
  278.            to click into here if you change the pattern in the horiz.
  279.            string gadget.  PAT will take care of it.
  280.  
  281.      (V)   PAT:  This is a very useful gadget.  (1) You enter a word into
  282.            the horiz. string gadget.  (2) You click into PAT.  Voila!  You
  283.            get all the files whose names contain the word highlighted.
  284.            I wrote a nice pattern matching sub-program for this.  It is
  285.            really very fast!  
  286.   
  287.            Enjoy!!!
  288.                            @@-->>> HERMES
  289.   
  290.  
  291.      Other programs by the author:
  292.  
  293.           PALETTA.ARC    (Color Mixing, Modifying IFF's, Random Colors)
  294.           DUHERM26.ARC   (Great Directory Utility.  Macros, Parameters, etc)
  295.           CALCULA.ARC    (An Expression Parser And A Function Evaluator)
  296.           SIMPLICA.ARC   (The Simplex Method Of Linear Programming)
  297.           ROST.ARC       (Reports On Storage And Tasks.  Useful!)
  298.           SCRIPTA.ARC    (Online!-PCP Script Maker.  Easy To Use!)
  299.           FORMULA!.ARC   (Great 3D-Grapher In C.  Colors, Parsing, etc.)
  300.  
  301.      For support on the HERMES programs, call:
  302.  
  303.          HERMES BBS (Tampa, FL, USA)
  304.          813-985-7624
  305.          1400 Files, 2400, PCP, Good Message Base, PRIVATE
  306.  
  307.      Also, you may call (voice) or write:
  308.  
  309.          A. G. Kartsatos (PLink = HERMES)
  310.          8524 Caladesi Island Drive
  311.          Tampa, FL 33637, USA
  312.          813-988-2146
  313.  
  314.  
  315. *****************************************************************************
  316.  
  318.  
  319. MachII  - Mouse Accelerator with Hotkeys.   Version 2.0  04-23-88.
  320.  
  322.        This program may be freely distributed but may not be used in any
  323.        commercial product without prior written permission.
  324.        Source available. Shareware donations accepted.
  325.  
  326.  
  327.        For those who hate doc files, just type "run MachII" and then
  328.        "Cancel" the "Can't Open Configuration File!". Now activate the
  329.        clock window with your mouse and press the right button. The
  330.        requester displayed has all of your options and hotkeys. Change
  331.        them to what you like and save it. AND TRY THIS; hit Alternate-
  332.        Escape then Amiga-F1 then type (for example) "diskcopy df0: to df1:"
  333.        then hit Alternate-Escape again. Now press Amiga-F1. Also look at
  334.        F1 in the requester. Read on if you're still interested.
  335.  
  336.  
  337.  
  338.     FEATURES
  339.  
  340.           Hotkeys         20 macros activated with the Amiga- or Ctl-Amiga-
  341.                           Function keys or by typing the first few letters
  342.                           of the macro.
  343.           Accelerator     Speeds up mouse movements. Adjustable.
  344.           PopCli          Execute a NewCLI or any other command.
  345.           Screen Blanker  Blank the screen after an adjustable period of
  346.                           time.
  347.           SunMouse        Activate a window by moving the mouse into it.
  348.           ClickToFront    Move a window to the front by clicking in any
  349.                           part of it.
  350.           Screen Shuffler Use Left_Amiga-M to push ANY screen to the back.
  351.           Clock           Title bar clock with memory watcher.
  352.           Alarm           Set an alarm.
  353.           Beeper          Beep every 15 minutes. Adjustable.
  354.           Meter           Maintain online costs. Adjustable rates.
  355.           Qualifier Accum Accumulate qualifiers to be added to a key.
  356.  
  357.           All features may be turned off. Unused hotkeys are passed through
  358.           and may be defined on the fly. Configuration saved to disk.
  359.  
  360.  
  361.  
  362.  
  363.     NOTES:
  364.  
  365.            1. All special keys and qualifiers except Amiga and Ctl-Amiga
  366.               Function keys may be changed on the command line.
  367.               The defaults are the Escape key qualified with:
  368.  
  369.               Alternate        Begin/End a macro definition.
  370.               Shift-Alternate  Begin accepting macro name.
  371.               Control-Amiga    Popup requester.
  372.               Amiga            Execute command string.
  373.  
  374.            2. When used in hotkey macros, function key numbers are
  375.               single digits. This means that 0 is F10, 1 is F1, 9 is F9.
  376.  
  377.  
  378.  
  379.  
  380.     UPDATES:
  381.         2.0   This is a major rewrite of Mach 1.6. Although it can still
  382.               do everything that the old one could (and more), the method
  383.               of setting your variables and hotkey macros has changed. It
  384.               is about 8k larger (about 20k) but if this is to big, you can
  385.               always use the old Mach. The nicest thing about this version
  386.               is the ability to define a hotkey macro on the fly and if
  387.               needed, edit it in a string gadget. There are now 20 hotkeys,
  388.               the Amiga-Function keys and the Ctl-Amiga-Function keys.
  389.  
  390.               Bug fix: The accelerator works properly with ProWrite.
  391.               May also help when using PageSetter.
  392.  
  393.  
  394.     OVERVIEW:
  395.  
  396.       MachII is a utility program that provides many optional features
  397.       for both CLI and WorkBench users. Your own configuration may be saved
  398.       to disk. Each function key may be used as a hotkey and hotkeys may
  399.       be defined on the fly. To do this, simply hit Alternate-Escape, an
  400.       Amiga-Function or Ctl-Amiga-Function key and then type your macro.
  401.       You will be prompted for these by messages in the clock and by beeps.
  402.       You may use any keys including qualifiers, arrow keys and numeric
  403.       keypad keys. When finished, hit Alternate-Escape again. You may now
  404.       use your macro by hitting the Amiga-Function or Ctl-Amiga-Function key
  405.       or by hitting Shift-Alternate-Escape, enough characters to uniquely
  406.       match the macro followed by return. You may also edit the macro in a
  407.       string gadget by hitting Control-Amiga-Escape or by activating the
  408.       clock window and pressing the right mouse button.
  409.  
  410.       A configuration file is not neccessary but without one you will get
  411.       the defaults. You will also get a "Can't Find Configuration File"
  412.       requester. After you have setup your macros and other variables,
  413.       save this to the file s:mach.config.
  414.  
  415.  
  416.  
  417.     USAGE:
  418.  
  419.        Run MachII [?ltfwmprn]
  420.  
  421.          Most people will not need any arguments. These are provided for
  422.          those who find a key combination that conflicts with another
  423.          program or who want the clock in a different location or want a
  424.          different config file.
  425.  
  426.          Arguments: All optional. Any order.
  427.  
  428.            ?         Display help.
  429.            -lnnn     Clock left edge. Default = 296.
  430.            -tnnn     Clock top edge. Default = 0.
  431.            -fname    Load configuration file "name". Default = s:Mach.config.
  432.            -w        Disable auto clock to front.
  433.            -mCALRSk  Change the macro begin/end key combination to the
  434.                      string following -m. -mAE is the default Alternate-ESC.
  435.            -pCALRSk  Change the PopCli/Command string key combination to the
  436.                      string following -p. -pLE is the default Left_Amiga-ESC.
  437.            -rCALRSk  Change the requester key combination to the string
  438.                      following -r. -rCLE is the default Control-Left_Amiga-
  439.                      ESC.
  440.            -nCALRSk  Change the macro invoking key combination to the string
  441.                      following -n. -nSAE is the default Shift-Alternate-ESC.
  442.                        C = Control.
  443.                        A = Alternate.
  444.                        L = Left-Amiga.
  445.                        R = Right-Amiga.
  446.                        S = Shift.
  447.                        k = Desired key
  448.                            T = Tab.
  449.                            E = ESC.
  450.                            D = Del
  451.                            B = Backspace.
  452.                            H = Help.
  453.                            F = F1. (F1 only!)
  454.                            0-9 = Numeric pad 0-9.
  455.                            - = Numeric pad -.
  456.                            . = Numeric pad ..
  457.                            e = Numeric pad Enter.
  458.  
  459.  
  460.      Usage eg. Run MachII -l270 -fs/wp
  461.  
  462.    After it is running, you may either activate the clock with the mouse
  463.    and press the right button or press Control-Left_Amiga-ESC. This will
  464.    pop up a requester jammed full of gadgets. All options and hotkeys
  465.    may be modified here.
  466.  
  467.      The gadgets are:
  468.  
  469.      1st ROW
  470.          left:   Toggle between Amiga and Control-Amiga hotkeys.
  471.          center: Clear all hotkey definitions.
  472.          center: Abort a macro definition.
  473.          right:  Change the maximum macro size.
  474.      2nd ROW
  475.                  Select each hotkey.
  476.      3rd ROW
  477.                  Hotkey definitions.
  478.      4th ROW
  479.                  Left_Amiga-ESC execute string.
  480.      5th ROW
  481.          left:   Activate/deactivate SunMouse.
  482.          center: Activate/deactivate ClickToFront.
  483.          right:  Activate/deactivate Screen Shuffler.
  484.      6th ROW
  485.          left:   Activate/deactivate Qualifier Accumulator.
  486.          center: Toggle clock.
  487.          center: Toggle online meter.
  488.          right:  Reset online meter.
  489.      7th ROW
  490.          left:   Select blanking interval. (0-99 minutes)
  491.          center: Select beep interval. (0-999 minutes)
  492.          center: Set the alarm time. 24 hour format.
  493.          center: Select online rate. ($00.00 - $99.99)
  494.          right:  Change the acceleration rate. (0-9)
  495.      8th ROW
  496.                  Configuration file name.
  497.      9th ROW
  498.          left:   Done.
  499.          center: Load configuration file.
  500.          center: Save configuration file.
  501.          right:  Remove MachII.
  502.  
  503.  
  504.      Hotkeys:
  505.  
  506.        There are 20 hotkeys. 10 are the Amiga-Function keys and 10 are the
  507.        Ctl-Amiga-Function keys. In the requester you can select each hotkey
  508.        with the Fn gadgets and toggle the Ctl-Amiga/Amiga gadget.
  509.        The hotkey macros may be edited in the string gadget. The default
  510.        maximum macro size is 255 characters but this may be changed in the
  511.        size gadget. You cannot change the size while you are creating a new
  512.        macro and the new macro size will not take effect until you select
  513.        "Done". This controls the size of dynamic buffers which are allocated
  514.        only during macro definition or when the requester is up. The actual
  515.        macros take up only as much space as they need.
  516.        Macros are invoked either by hitting the Amiga- or Ctl-Amiga-Function
  517.        key or by hitting Shift-Alternate-Escape and then type some of the
  518.        first letters of the macro and then return. The first macro found
  519.        that matchs will be executed. If none is found there will be a beep.
  520.        See the overview for defining hotkey macros.
  521.  
  522.        The escape character "\" may be used for the following:
  523.  
  524.            \N  Newline.
  525.            \T  Tab.
  526.            \E  Escape.
  527.            \D  Del.
  528.            \B  Baskspace.
  529.            \H  Help.
  530.            \u  Up arrow.
  531.            \d  Down arrow.
  532.            \l  Left arrow.
  533.            \r  Right arrow.
  534.            \0  Number pad 0.
  535.             .
  536.             .
  537.            \9  Numeric pad 9.
  538.            \.  Numeric pad ".".
  539.            \-  Numeric pad "-".
  540.            \e  Numeric pad ENTER.
  541.            \F1 Function key 1.
  542.             .
  543.             .
  544.            \F0 Function key 10.
  545.  
  546.          Qualifiers modify the character immediately following these:
  547.  
  548.            \C  Control.
  549.            \S  Shift.
  550.            \A  Alternate.
  551.            \L  Left-Amiga.
  552.            \R  Right-Amiga.
  553.  
  554.        Function keys not assigned to a hotkey string are passed through.
  555.  
  556.     Accelerator:
  557.  
  558.        The accelerator speeds up mouse movements.
  559.        Its speed is set 0 - 9.
  560.        0 = no acceleration. (I use 4).
  561.  
  562.     NewCLI:
  563.  
  564.        The Left-Amiga and ESCape combination will create a NewCLI.
  565.        You need to have NewCLI and Run in the c: directory. The NewCLI
  566.        will have the same size stack as MachII. You can change the command
  567.        in the execute string gadget.
  568.        A full window example is "NewCLI CON:0/0/640/200/MyCLI".
  569.  
  570.     Screen Blanker:
  571.  
  572.        After 5 minutes of no mouse or keyboard activity, the screen will
  573.        go blank. You can change this default in the Blanking gadget.
  574.        0 disables blanking.
  575.  
  576.     Sun Mouse:
  577.  
  578.        The window that the pointer is over becomes the active window
  579.        after the first mouse movement. To be able to drag icons, the
  580.        Sun Mouse is disabled while the left button is held down.
  581.        Turn on or off with the SunMouse gadget.
  582.  
  583.     Click To Front:
  584.  
  585.        You can click in any part of a window and bring it to the front.
  586.        Turn on or off with the ClickToFront gadget.
  587.  
  588.  
  589.     Screen Shuffler:
  590.  
  591.        Left_Amiga-M will push the front screen to the back instead of
  592.        pushing workbench to the back. Left_Amiga-N will still bring the
  593.        workbench to the front. This is useful if you have more than two
  594.        screens on at once, especially if they don't have screen depth
  595.        gadgets.
  596.        Turn on or off with the Amiga-M gadget.
  597.  
  598.     Clock:
  599.  
  600.        MachII has a title bar clock that displays available memory and the
  601.        time. You can change its left edge position with -lnnn and the top
  602.        edge with -tnnn. The clock is updated every second and brings itself
  603.        to the front (if covered up) every 4 seconds except when the left
  604.        button is held down. Sometimes this covers up information in the
  605.        title bar so if you don't like this use the option -w. This disables
  606.        the auto upfront and adds an (almost) invisible depth gadget.
  607.        Activate the clock with the mouse and press the right button to
  608.        pop up the requester.
  609.        Turn on or off with the Clock gadget.
  610.  
  611.     Alarm:
  612.  
  613.        You may set 1 alarm time in 24 hour format. When it goes off, it
  614.        will beep longer than the interval beeper and the screen will
  615.        flash.
  616.  
  617.     Beeper:
  618.  
  619.        MachII has a beeper (to keep you awake) which defaults to a 15
  620.        minute interval. Change this in the Beeping gadget.
  621.  
  622.     Meter:
  623.  
  624.        MachII has an online cost meter. Use the Meter gadget to toggle
  625.        between the meter and the clock. Use the Reset gadget to reset
  626.        the meter. The rate that it uses may be set in the Online Rate
  627.        gadget. The meter runs continuously whether visible or not.
  628.        The default rate is $4.75.
  629.  
  630.     Uninstall:
  631.  
  632.        Use the Remove gadget to uninstall MachII.
  633.  
  634.  
  635.  
  636.  
  637.     EXAMPLES:
  638.  
  639.        Run MachII -l328 -t190 -mCSE -fs:maconfig
  640.          This puts the clock at a left edge of 328 and a top edge of 190,
  641.          uses Control-Shift-Escape to begin/end hotkey macros and loads
  642.          your configuration from the file s:maconfig.
  643.  
  644.        Run MachII -pLT
  645.          This sets the PopCli key combination to Left_Amiga-Tab.
  646.  
  647.        Run MachII -ne -fs/wpcfig
  648.          This sets the macro invocation key to the keypad "Enter" key and
  649.          loads a configuration file in the s directory named wpcfig
  650.  
  651.        Run MachII -mS. -rAH
  652.          This sets the requester popup key combination to "Alternate-Help"
  653.          and the macro invocation to "Shift-NumericPad ." .
  654.  
  655.        Run MachII -rLRH
  656.          This sets the requester popup key combination to the "Left_Amiga-
  657.          Right_Amiga-Help".
  658.  
  659.        Watch out that you don't have keys in conflict. The results of two
  660.        functions that are assigned to a single key combination is unknown
  661.        and is bound to cause headaches.
  662.  
  663.  
  664.  
  665.     MISCELLANEOUS:
  666.  
  667.        I have found that the hotkeys do not function properly with the
  668.        program Sili(Con:). When a string gadget (or any gadget anywhere)
  669.        is active, the SunMouse does not work.
  670.        Let me know if you find any incompatibilities.
  671.  
  672.        MachII may fail to run for any number of reasons (e.g. no free
  673.        signals, insufficient memory). You will be informed of this if it is
  674.        started with the Run command. If started from RunBack or
  675.        RunBackGround (public domain program that will allow the CLI window
  676.        to close and available on Fred Fish disk # 65) MachII won't run and
  677.        you won't get any messages.
  678.  
  679.        The NewCLI brought up by Left_Amiga-ESC will have a stack the same
  680.        size as MachII. Many programs that you may run from this CLI need a
  681.        larger stack so either run MachII with a larger stack or, after you
  682.        get a NewCLI, use the stack command to set your stack to a larger
  683.        value. If programs mysteriously crash when run from the NewCLI, it
  684.        may be caused by the stack size.
  685.  
  686.        If the macro size is set too small and you try to load a config file
  687.        with longer macros, you will get a "Not A Mach Configuration File!"
  688.        message. If you set the size too small and then select "Done" then
  689.        activate the requester again, the macro size will be set to the
  690.        size needed for the largest macro.
  691.  
  692.  
  693.  
  694.  
  695.     SPECIAL FEATURE:
  696.  
  697.        Many disabled people find it difficult if not impossible to
  698.        type key combinations such as Control-Shift-F1. MachII has
  699.        the ability to remember qualifiers that are pressed and add
  700.        them to the first non-qualifier key pressed. So you could for
  701.        example, type Control, Alternate, and then F1. The Control
  702.        and Alternate would be added to the F1 just as if they were
  703.        pressed at the same time. This is not for someone who doesn't
  704.        need it as it sometimes may cause unexpected results. If you
  705.        type Control and then change your mind, the Control will still
  706.        be added to the next key pressed. Pressing Caps Lock will
  707.        reset the qualifier accumulator.
  708.        Note that because most people will not want this, it defaults to
  709.        off unlike all the other features.
  710.        Turn on or off with the Qual Accum gadget.
  711.  
  712.  
  713.  
  714.  
  715.  
  716.        Copyright 1988 by Brian Moats
  717.                          Polyglot Software
  718.                          10431 Ardyce Court
  719.                          Boise, Idaho 83704
  720.  
  721.                          PeopleLink - BrianM
  722.                          CI$        - 76167,2334
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.   Other programs for the Amiga 500/1000/2000 from Polyglot Software:
  731.  
  732.  
  733.   M18Cheater - Lets you cheat in Mean 18 by causing your opponent to
  734.                slice. Public domain.
  735.  
  736.   FunBut - Lets you use the F1 key instead of the left mouse button.
  737.            It's useful when playing games like Defender of the Crown
  738.            because it sends repeat mouse clicks.  Public Domain.
  739.  
  740.   4 IN ONE - Four easy to play games on one disk.
  741.  
  742.              SlotCars          For 1 or 2 players, arcade type driving and
  743.                                shooting game. Seven screens, great graphics.
  744.  
  745.              CircuitMania      For 1 or 2 players, surround your opponent
  746.                                in a maze of wires.
  747.  
  748.              ShufflePuzzle     Like the sliding number puzzles that you used
  749.                                to play as a kid but this uses beautiful color
  750.                                pictures.
  751.  
  752.              Follow That Tune  Follow the bouncing boy as he jumps from
  753.                                pedestal to pedestal playing musical notes.
  754.  
  755.              These games are integrated into an easy to use package.
  756.              Enjoyable for all ages. All use digitized sound.  $29.95
  757.  
  758.   Dominoes - 3d graphics, speech, tutorial. More entertaining and
  759.              challenging than Shanghai.  $24.95
  760.  
  761.   The Crossword Creator - Make or solve crossword puzzles. 40,000+ word
  762.                           pattern matching dictionary, med-res or interlace,
  763.                           IFF compatible and many more features. $49.95
  764.  
  765. *****************************************************************************
  766.  
  768.    Pyro!  (C) 1988 By: Steve Jacobs & Jim Boyd
  769.  
  771.  
  772.   THIS PROGRAM IS FREEWARE, UPLOAD IT! GIVE IT TO YOUR FRIENDS AND ENEMIES!
  773.   OR THROW IT AWAY IF YOU WISH!
  774.  
  775.   Pyro! is a screen blanking program that goes beyond the normal screen
  776. blanking process. If there are ABSOLUTELY NO input events (mouse movements,
  777. keyboard presses or disks inserted or removed) Pyro! Takes over and starts
  778. a little fireworks display in color! Like real fireworks displays it has a
  779. few duds too! As soon as Pyro! detects any input messages it closes down the
  780. fireworks display and you are right back where you were.
  781.  
  782.   To Unload Pyro! press and hold down the left ALT key (first) and the CTRL
  783. key. Pyro! will tell you if it cleaned itself up.
  784.  
  785.   Future enhancements:
  786.  
  787.    1- Make Fireworks display more realistic.
  788.    2- Add sound effects.
  789.    3- Drink a beer and watch the show!
  790.  
  791.  Oh Yea. The no events time is preset at 5 minutes. This means if there are
  792. no input events for 5 minutes you get a free fireworks display! 
  793.  
  794.   What do we want for this? Frankly, other than being a neet little hack it
  795. doesn't do much other than save your monitor from burn in. So what we want
  796. is for Amiga users to have fun with it and make BETTER little hacks like this
  797. one!
  798.  
  799.                                         Steve Jacobs (GEnie: S.JACOBS)
  800.                                              &
  801.                                         Jim Boyd     (PLINK: ????????)
  802.  
  803.  ps: Any bugs leave EMAIL to me on GEnie or Jim on People Link. Sorry Jim
  804.      I didn't know your PLINK name!
  805.  
  806. *****************************************************************************
  807.  
  809.  SpeechToy.c  Original by Dave Lucas, Enhancements by Rob Peck.
  811.  
  812. /* o  Can now read and write its own icon to get the defaults you set.
  813.  * o  New menu item added to save current speech settings.
  814.  * o  Can be started from WBENCH or CLI; if from CLI, can still
  815.  *    read the icon file to get the default values.
  816.  *
  817.  * In the toolstrings, the data takes the form:
  818.  *
  819.  * SEX=1
  820.  * SEX=0
  821.  * for female (1) or male (0) voice.
  822.  *
  823.  * MODE=0
  824.  * MODE=1
  825.  * for expressive (0) or robotic (1) voice.
  826.  *
  827.  * FREQUENCY=20000
  828.  * numeric range from sampling frequency MIN to 
  829.  * frequency MAX (see the audio.h file)
  830.  * 
  831.  * RATE=150
  832.  * words per minute rate, see audio.h for range.
  833.  *
  834.  * VOLUME=64
  835.  * volume range from 0 to 64 (max).
  836.  *
  837.  * PITCH=224
  838.  * pitch value for speech, range see audio.h
  839.  *
  840.  * These values can be saved in the icon by using the save menu item
  841.  * --------------------------------------------------------------------
  842.  *
  843.  * WORDS=This is Amiga Speaking
  844.  * anything you want it to insert in the English Phrase area.
  845.  *
  846.  * TRANS=1
  847.  * means: Translate whatever words there are in the english.
  848.  *
  849.  * SPEAK=1
  850.  * means: Say it.  When this is in the icon, it opens up talking.
  851.  *
  852.  * PHON=DHIHS IHZ AHMIY3GAH SPIY4KIHNX.
  853.  * This is the way you insert your own custom pronunciation.
  854.  * Note that it MUST be legal phonetics per the Speech docs.
  855.  */
  856.  
  857. /* AREXX support:
  858.  *
  859.  * AREXX port is named SPEECHTOY, so that AREXX, which capitalizes
  860.  * things automatically, doesn't need quotes on the name to
  861.  * prevent it from capitalizing and not finding the port.
  862.  *
  863.  * To change any parameter, do EXACTLY as the toolstrings description
  864.  * shows... I use the SAME routines to parse the command that AREXX
  865.  * sends as are used to decode the icon's toolstrings.
  866.  *
  867.  * To send a command directly from a CLI interface, using AREXX
  868.  * support function, do this:
  869.  *
  870.  * rx "address speechtoy 'WORDS=Say this you turkey'"
  871.  * rx "address speechtoy 'TRANS=1'"
  872.  * rx "address speechtoy 'SPEAK=1'"
  873.  */
  874.  
  875. /* CLI startup:
  876.  *
  877.  * To allow speechtoy to read its own icon, either CD to the
  878.  * directory where speechtoy is located, then:  run speechtoy
  879.  * OR CD anywhere, then:
  880.  *
  881.  *     run speechtoy <dir-where-icon-is-located>
  882.  *
  883.  * example:
  884.  *
  885.  * CD DF0:
  886.  * RUN df1:speechtoy df1:
  887.  */
  888.  
  889. /* COMPILING:  Lattice - compiles cleanly under Lattice 3.03 and 4.0
  890.  *             if stack is set to 20000
  891.  *
  892.  *             Manx 3.4b compiles cleanly, used for this object file.
  893.  *           Use "cc +L toywork9.c" and "ln toywork9.o c32.lib"
  894.  *             (have not tried to adjust it for 16 bit integers).
  895.  *
  896.  * Original LUCAS comments (for most part) removed, see the FISH
  897.  * disk with original speechtoy to see what was there before.
  898.  * File got up over 65k source when I was through with it.
  899.  *
  900.  * Enhancements needed:  Add capability to input PHONETIC strings.
  901.  *                       Strip it down into just a speech server
  902.  *                       with no windowing interface, but still read
  903.  *                       the icon file for the defaults.
  904.  */
  905.  
  906. /* Written by David M Lucas. */
  907. /* Enhanced by Rob Peck */
  908.  
  909. *****************************************************************************
  910.